home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-0039 / degascon.doc < prev    next >
Text File  |  1997-04-16  |  8KB  |  216 lines
  1.                Degas Convert & Print Program      
  2.                -----------------------------
  3.  
  4.      Graham Miller
  5.  
  6.      21 Elm Road,
  7.      Winwick,
  8.      Warrington,
  9.      Cheshire  WA2 9TW
  10.  
  11.  
  12.      Feel free to write to me with any comments on the program,
  13.      improvements to it, Modula-2 programming or programming in
  14.      general. I will reply to all letters.
  15.  
  16.      If anyone sends me details of other picture formats on the
  17.      ST. I will try and arrange for DegasConvert to load & 
  18.      convert them.
  19.  
  20.      A reminder: The program and the source code are public 
  21.                  domain. You will need the FTL Modula2 compiler 
  22.                  and assembler if you wish to use the source code
  23.                  'as is'. 
  24.  
  25.      Version 2.04 Amendement                     September 1989. 
  26.      -----------------------
  27.  
  28.      Differences from Version 2.03:
  29.           Load compressed DEGAS pictures and pictures saved 
  30.           from LOGO.
  31.  
  32.           This version should run on an ST with 512K of memory.
  33.           Due to a misunderstanding between myself and the 
  34.           Modula-2 linker, version 2.03 will not run correctly 
  35.           on a 'small' ST.
  36.  
  37.  
  38.      Version 2.03 Amendments:
  39.      ------------------------
  40.  
  41.      1) Its quicker!
  42.                          Ver 2.02            Ver 2.03+   
  43.                          --------            --------
  44.           Low-res pic     19 secs             10 secs
  45.  
  46.           Med-res pic     24 secs             17 secs
  47.  
  48.      Some notes on the speed: This program converts about 6400 
  49.          low-res pixels per second ( 7500 med-res pixels/sec ).
  50.          This is enough time for about 200 machine instructions
  51.          per pixel.
  52.  
  53.      2) The palette is displayed in intensity order when
  54.         shown. 
  55.  
  56.      3) Equal entries in the palette are assigned the same 
  57.         print bit pattern when the picture is first loaded.
  58.         It does this by using the lighter of the colours for
  59.         the lighter half of the palette and the darker pattern
  60.         in the lower half.
  61.  
  62.      4) The following picture types are known and loaded correctly
  63.         by the program:- a) Degas   ( PI1, PI2 & PI3 )
  64.                          b) Tny     ( TNY, TN1, TN2 & TN3 )
  65.                          c) Neo     ( NEO )
  66.                          d) Doodle  ( DOO )
  67.                          e) Compressed Degas ( PC1, PC2, PC3 )
  68.                          f) Pictures saved from LOGO ( PIC ).
  69.  
  70.         If a picture type is not one of the above but is the
  71.         same size as a degas picture file then it will be treated
  72.         as such and loaded.
  73.  
  74. Purpose of the program.
  75. -----------------------
  76.      To convert any Degas picture to hi-resolution and print the
  77. converted picture on an Epson or compatible dot-matrix printer.
  78.  
  79.      It will also save a selected portion of a picture as a '.IMG' file.
  80.  
  81.  
  82. Instructions for use.
  83. --------------------
  84.      You need the resource file 'DCRSC.RSC' on the same disc as the 
  85. program DEGASCON.PRG.
  86.  
  87.      The program will work in High & Medium resolution.
  88.  
  89.  
  90. What you can do:
  91. ----------------
  92.  
  93.      1) Load a picture: Degas or any known picture. 
  94.           
  95.      2) Save the converted picture as a DEGAS hi-res picture.
  96.  
  97.      3) Assign different patterns to each palette colour:
  98.  
  99.           a) Use the 'PATTERNS...' option on the PICTURE menu.
  100.  
  101.           b) click with the left button anywhere in the window. A
  102.              dialog is entered which will show the colour of the pixel
  103.              that the mouse is on, and the current print pattern
  104.              associated with it. Edit the print pattern to change it.
  105.              Use the CONVERT option on the PICTURE menu to
  106.              re-convert the picture with the new pattern(s).
  107.           
  108.  
  109.      4) Select a portion of the picture to be printed.
  110.      
  111.           a) press the 'ESC' key ( or use the 'Image' menu option ) 
  112.  
  113.              You will see a full screen display with a default selected
  114.              portion of the picture in the middle of the screen.
  115.  
  116.              Click and hold in the box to drag it about the picture.
  117.              The box can be re-sized by clicking and dragging in the 
  118.              lower-right corner.
  119.  
  120.              Click with the LEFT button anywhere outside the box to
  121.              accept it. Click on the RIGHT button to cancel this
  122.              display and return to to the main display.
  123.  
  124.              The co-ordinates and size of the accepted box will
  125.              update the co-ordinates in the SIZE option on the
  126.              PRINT menu. The print size will be made the same
  127.              as the box size, i.e. the printed picture will
  128.              not be scaled.  
  129.             
  130.      5) Scale the picture when it is printed.
  131.  
  132.           a) Select the SIZE option on the PRINT menu.
  133.  
  134.              This displays a dialog with the co-ordinates and size
  135.              of the selected picture ( full size by default ).
  136.  
  137.              Also the current size of the picture when printed
  138.              is displayed. If these values are changed then the
  139.              picture will be scaled by the appropriate amount
  140.              when printed. 
  141.              
  142.              The starting co-ordinates ( in character positions )
  143.              of the printed picture on the page can be altered on this
  144.              dialog.
  145.  
  146.      6) To print the picture, select PRINT from the PRINT menu.
  147.         Also select the direction to be printed ( Landscape or Portrait)
  148.         
  149.      7) To save the selected portion of the picture as a '.IMG' file
  150.         suitable for importing into DTP packages. Click on 
  151.         'Image...' in the FILE menu. You must select a portion
  152.         of the picture first. If you don't do this, the full 
  153.         picture is selected as an 'IMG' file. 
  154.      
  155.           -------------------------//-----------------------     
  156.              
  157.  
  158.      Assigning different print patterns to the colours:
  159.  
  160.      Wot happens on loading a picture:
  161.        When a picture is loaded each colour used in the picture 
  162. is assigned a pattern of dots ( four dots for a low-res picture, 
  163. two dots for a med-res picture ). The number of dots in the 
  164. pattern is decided mainly by the brightness of the colour. Also 
  165. each colour gets a different pattern of dots. Equal colour entries
  166. in the palette are then given the same print bit pattern from the
  167. previous/next entry depending on which half the palette is in.
  168.  
  169.      How to change the print patterns:
  170.      ---------------------------------
  171.           On the PICTURE menu there is the option PATTERNS..., 
  172. clicking on this throws up a dialog for the current settings. 
  173. Each entry consists of three parts: RGB ( Red, Green & Blue 
  174. components of the colour in that position in the palette ), the 
  175. index number of the palette entry ( where it is in the palette ) 
  176. & the Print Bit Patterns associated with this colour. This 
  177. consists of a series of 1's and 0's. A '1' indicates a dot will 
  178. be printed, a '0' indicates no dot. There are four dots to be 
  179. printed for each low-res picture pixel and all sixteen colours 
  180. are used. In a med-res picture, the are two dots printed for each 
  181. pixel and only the first four entries are used.
  182.  
  183.           To change a pattern, edit the Print Bit Pattern with 
  184. the appropriate series of 1's & 0's. If you exit the dialog by 
  185. pressing ENTER or clicking on the CONVERT box, the picture will be 
  186. reconverted using the latest patterns. Clicking on the CANCEL 
  187. button will ignore the changes made during this use of the 
  188. dialog.  
  189.  
  190.  
  191.      To stop a print partway through then click on any  mouse
  192. button. You will be prompted whether to abort the print or not.
  193. If your printer is offline then after about 30 seconds you will get
  194. an alert prompting you about it.
  195.  
  196.  
  197. Some features ( if they are documented they are not bugs! well,
  198. maybe... )
  199.  
  200.      When non-integer scaling is used in the print, the picture can
  201.      sometimes look very odd. I cannot find anything obviously wrong
  202.      with the scaling routines and suspect the effects are artifacts
  203.      of the technique I have used ( This means I don't know why it
  204.      looks odd! ). 
  205.  
  206.  
  207.      ------------------------------//-----------------------------
  208.  
  209.      This version was programmed in FTL Modula-2 from HiSoft. This
  210.      is an excellent implementation and development environment.
  211.  
  212.  
  213.                     Graham Miller
  214.  
  215.  
  216.